COMMENT ⊗   VALID 00005 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002			Using TOSCIP to Transfer Tapes
C00005 00003
C00009 00004
C00012 00005
C00016 ENDMK
C⊗;
		Using TOSCIP to Transfer Tapes


TOSCIP is a program to read and write tapes that are  compatible
with IBM machines.

TOSCIP can be used  to transfer data between  SCIP and LOTS  via
magnetic tape.   TOSCIP  was  originally written  to  make  this
transfer easier.  There are also  two public execfiles at  SCIP,
TOLOTS and FROMLOTS to help write the Job control language (JCL)
to do the writing or reading at SCIP.

NOTE:  Only  data in  character form  may be  transferred  using
TOSCIP.  This means  that a few  of the things  you CANNOT  move
are;  SPSS save files, files written with FORTRAN's  unformatted
WRITE, compiled  programs (REL  files), or  executable  programs
(EXE files).


I.  Documentation

You  can  get  more  information  about  TOSCIP  from  the  file
DOC:TOSCIP.DOC on line at LOTS.

For information on  reading and writing  tapes at SCIP,  consult
the SCIP publications TAPE USE,  "Moving Files to LOTS", or  THE
IOPROGM MANUAL, in the  study racks at  Pine Hall, or  avaliable
from SCIP document sales.


II.  Using TOSCIP

To use TOSCIP, you should first obtain exlusive access to the
tape drive by means of the ASSIGN command, then mount your tape
(if you have never mounted a tape before, ask a consultant for
assistance), and then run TOSCIP.  TOSCIP will prompt you with
"TOSCIP>".  For example:

    @assign mta0:
  [ mount your tape ]
    @toscip
    TOSCIP>

Use of TOSCIP  will generally  consist of one  or more  commands
which tell TOSCIP  what format  your tape is  in, possibly  some
tape motion commands which position the tape to the proper file,
READ or WRITE commands to actually tranfser data, and finally  a
QUIT command.



III.  Basic commands

The most basic commands are READ  and WRITE.  READ reads a  file
starting at the current position on the tape and WRITE writes  a
file to  the tape  starting at  the current  position.  Both  of
these commands require a file name as an argument.  For example:

    TOSCIP>write myfile.txt

will write the contents of file MYFILE.TXT to the tape.

    TOSCIP>read myfile.txt

performs the reverse operation.

The SCIP command will generate  one of two standard formats  for
the execfiles at SCIP.

    TOSCIP>scip card

generates records that  are 80 characters  long, just right  for
most programs such  as FORTAN,  or SPSS data  or control  cards.
This format  translates  lower case  to  upper case.  (most  IBM
compilers can't read lower case)

    TOSCIP>scip print

generates records that are 133  characters long, just right  for
text files certain kinds of programs that use long lines.   This
format does not translate  lower case to  upper case.  The  SCIP
commands, if used, should be given BEFORE any reads or writes.

Various other tape formats  may also be  written or read.   When
using them,  you should  give  the DISPLAY  command  immediately
before reading or writing to  see what format TOSCIP thinks  you
are using.  When reading, this  format should exactly match  the
format used to write the tape.  When reading, you should  record
this information carefully -- it will be needed when you try  to
read the tape later.

Each disk file  corresponds to  one tape "file".   You may  have
several files stored on tape at  one time, which means that  you
will have to tell  TOSCIP which one you  want to read or  write.
Note that you  may only write  at the logical  end of the  tape.
Thus, if you  have three  files on the  tape, and  you skip  the
first then save a new set of files where the second used to  be,
the third file is irretreviably lost.



To skip 5 files on the tape, give the command:

    TOSCIP>skip 5

To move to the current  end of the tape  (so you can write  more
files without  destroying  old  ones),  give  the  END  OF  TAPE
command:

    TOSCIP>eot


IV.  SCIP to LOTS data transfer

You must first  have a  magnetic tape.  These  are available  in
various sizes from SCIP  document sales.  If  you will be  using
the tape much it is recommended that you buy a 2400' tape (cost:
about $13.00).  Avoid very small (600' or less) tapes.

Next you must submit the tape at the Pine Hall Information Desk.
They are usually open  from about 8:00am  to 11:00pm during  the
week and from around 2:00pm to 6:00pm onthe weekends.  You  must
submit the tape as a nine-track, non-labled, 1600 bpi tape.   If
the tape does not have anything  on it written at 1600 bits  per
inch it  MUST be  initialized.   CAUTION:  INITIALIZING  A  TAPE
ESSENTIALLY DESTROYS ALL THE DATA ON IT!!!!!

Your tape will be assigned a volume serial number starting  with
'AX' EXAMPLE:   AX1307, you  will  need to  keep track  of  this
number since it  is how  you must refer  to your  tape. Ask  the
person at the desk when the tape will be ready for use and  come
back at that time.

Next, log on to a SCIP terminal and give the Wylbur command:

	EXEC FROM #TOLOTS PUBLIC ON CAT

Answer the questions the execfile  asks.  After it is done  give
the RUN command and your job will be submitted.  You can log off
and  periodicl check on its progress by using the LOCATE command
at the lobby terminal in Pine Hall.  Your output will go to your
default bin.  If there  were no errors in  the run you can  fill
out a tape checkout form at the information desk.

When you get your  tape, bring it  to LOTS and  mount it on  the
tape drive.  At your terminal type:

	TOSCIP



When the system replys: TOSCIP>  give the command SCIP  followed
by  the   format  you  used  told  TOLOTS  to  use.   Give   any
appropriate SKIP  commands, (if  the file  you want  is not  the
first on the tape)  and then give the  READ command to  transfer
the data on the tape to a LOTS file.

When you are done give the command QUIT, and remove your tape.


V.  LOTS to SCIP data transfer

You must  first have  a magnetic  tape. These  are available  in
various sizes from SCIP  document sales.  If  you will be  using
the tape  much it  is  recommended  that you  buy a  2400'  tape
(cost: about $13.00).  Avoid small (600' or less) tapes.

Put your tape on  the LOTS tape  drive, following the  threading
instructions on the drive.  At  your terminal give the  command:
TOSCIP.  When the system responds: TOSCIP> give the command SCIP
followed by whichever standard format  you would like to use  to
write on the  tape.  Then give  the WRITE command  to write  the
file(s) you wish to transfer onto the tape.  When you are  done,
give the QUIT  command and  then type DEASSIGN  MTA0:  to  allow
others to use the tape drive.

Take your tape to the Pine  Hall Information Desk and submit  it
as  1600  bpi, nine-track,  non-labled.  DO  NOT HAVE  THE  TAPE
INITIALIZED OR YOU  WILL DESTROY  THE DATA ON  IT!!!!!  Ask  the
person at the desk when the tape will be ready, and come back at
about that time.

Next, log on to a SCIP terminal and give the Wylbur command:

	EXEC FROM #FROMLOTS PUBLIC ON CAT

Then answer the questions the  execfile asks.  After it is  done
you give the RUN command to submit the job to copy the data from
the tape to files at  SCIP.  You can log  off and keep track  of
the  progress of  the job  through the system  using the  LOCATE
command at the lobby terminal in Pine Hall.  The output from the
job will be delivered to the  default bin for your account.   If
there were  no errors  in the   run,  you can  fill out  a  tape
checkout form at the info desk  if you would like to check  your
tape out.